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I ntroduct ion 


This  memo  describes  the  use  of  the  DAISY/APL  Interface,  and 
the  functions  currently  implemented  unde'  APL  which  may  be  of 
interest  to  the  DAiSY  user.  The  reader  is  assumed  to  be 
familiar  with  the  DAISY  User's  Memo  (IV  It  should  be  noted 
that  when  the  user  Is  in  the  DAISY/APL  envlf^onment,  the  spelling 
correction  features  of  DAISY  will  not  be  pnesent. 


(I 


TOAPL  Command 

The  DAISY  user  can  enter  APL  mode  by  tyiing  the  DAISY 
command 

TOAPL  terminal 

where  the  terminal  parameter  must  be  cne  of  tty,  t27iil , t4013,or 
bit.  This  indicates  the  type  of  terminal  which  the  user  Is 
operating.  The  system  vlll  then  pass  this  Information  along 
with  the  user's  name  to  APL.  The  response  will  be 
DAISY/APL  INTERFACE  SAVED  date  tiiie 
followed  either  by  the  loading  of  the  user's  workspace,  or  the 
message  indicating  that  such  a workspace  Is  being  created.  At 
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this  point  the  user  has  available  all  of  the  functions  to  be 
described  below^  along  with  the  full  power  of  apl.  The  user 
should  be  careful  when  using  or  copying  workspaces,  and  should 
save  his  workspace  only  with  the  DASAV:  command  described  below. 

DAISY  Command 

To  return  from  APL  back  to  the  main  command  Interpreter, 
the  APL  function 
DAISY 

Is  typed.  This  closes  files,  etc.,  and  returns  control  to 
DAISY. 

DAISYWORK  Command 

The  command  DAISYWORK  Is  available  for  creating  lines  which 
are  to  be  processed  by  the  main  DAISY  command  system  when 
control  returns  there.  For  example,  the  user  might  wish  to 

trigger  a decision  In  the  DAISY  system,  based  on  the  action  of 

some  APL  function.  THe  s/ntax  Is: 

DAISYWORK  strin; 

which  adds  the  command  " string  " to  the  file  of  work  lelng 

built  for  execution  by  DAISY.  When  the  next  DAISY  command  Is 

given,  this  file  will  be  processed  before  any  additional 
commands  are  accepted  from  the  console.  For  example  "DAISYWORK 
•TRIGGER  103'"  followed  by  "DAISY"  will  cause  the  command 


iiii 
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103" 


to  be  executed  as  soon  as  DAISY  Is  reentered. 


I 
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j Rather  than  using  the  standard  APL  )SAVE  command  to  save 

I 

any  data  or  functions  the  user  has  placed  In  his/her  workspace^ 
the  command 
DASAVE 

I must  be  used.  This  function  will  clean  out  the  Interface  and 

other  standard  functions  before  saving  the  workspace,  and  will 
copy  them  back  after  the  saving  has  taken  place. 

Submarine  Data  Functions 

there  are  currently  five  functions  Implenented  which  are  used  to 

read  In  the  data  on  submarines  and  submarine  classes  prepared 

for  the  project.  (These  data  are  also  available  on  the  370/168 

Ij  In  either  ASAP  or  REL  form).  The  function: 

I GETSUBDATA 

Nk 

j Is  used  to  open  the  two  files  for  input.  File  1 contains  the 

|]  Information  on  submarine  classes,  and  file  2 has  the  Irformatlon 

I on  Individual  submarines.  The  function  : 

ii 

.i  READAS  n 

,1 

1 where  n Is  1 or  2,  reads  the  next  record  from  the  specified 

file.  When  through  with  the  data,  the  function  : 

CLOSESUBDATA 


1 
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will  close  and  deassign  the  files  for  later  use.  It  should  be 


I 
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Submarine  Data  Function; 

noted  th;  t If  a DASAVE  command  Is  given  when  the  flies  are  open, 
the  file  assignment  Information  Is  also  saved,  and  further  opens 
are  not  necessary. 

There  are  four  additional  functions  Implemented  which  are 
used  to  find  data  about  an  individual  submarine  or  class  of 
submarines.  The  Function: 

CLASSREC  string 

locates  the  class  record  Identified  by  Its  class  name,  which  Is 
given  In  the  string. The  function: 

CLA;  S string 

uses  CLASSREC  to  locate  the  class  record  indicated  hy  its  class 
name.  /11  relevant  data  about  the  class  Is  returned.The 
function 

SUBFEC  string 

locates  le  submarine  record  identified  by  Its  pennant,  which  is 
given  In  the  string.  The  function: 

PENNANT  string 

uses  SUBREC  to  locate  the  appropriate  subm’arine  record,  where 
string  ii  the  pennant,  and  returns  all  data  In  the  record.  For 
example; 

PENNANT  's  501'  would  return  THE  NAME  OF  SUB  IS  GIADA  OWNED 
BY  ITALY  UASS  ACCIAIO  COMPLETED  1941bsect  <Data  I tern  Functions> 
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There  are  three  functions  which  allow  the  user  to  locate, 
dIslay  and  set  the  ''alues  of  Individual  data  Items. 

LOCATE  function 

stringl  LOCATE  strlng2 

where  stringl  Is  a lata  I tern  number  given  as  'DATA  302'  and 
strlng2  is  an  I tern  name  such  as  'TORPEDOES',  verifies  that  both 
exist  and  returns  the  location  of  the  value.  If  the  given  Item 
name  (In  this  case  TORPEDOES)  is  not  found  in  the  file,  you  will 
be  asked  If  you  would  like  It  added  or  not.  If  so,  the  file 

will  be  expanded  an  I initialized  to  O's  for  this  Item. 

DISPLAY  function 

stringl  DISPLAY  strlng2 

displays  the  value  of  the  data  Item  Identlflfd.  stringl  and 
strlng2  are  as  In  tlie  LOCATE  function. 

SET  function 

tringl  SET  strlng2  locates  the  data  Item  value  Identifed  by 
stringl  and  strlng2  and  then  requests  numeric  Input  which  Is 
then  set  as  the  value  of  the  data  Item. 
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Plotting  Functions 

There  are  currently  three  functions  which  are  available  If 
the  user  has  a Tektronix  4013  storage  tube  terminal  or 
equivalent.  These  are  used  to  provide  line  drawings  ';hlch  may 
be  of  assistance  to  the  decision  maker. 

COORD  Function 


coord  r uses  the  per  hour  speed  >f  the  submarine  to  calculate 
the  points  of  a circle  of  radius  R and  of  radius  2R.  It  puts 
these  points  In  the  proper  order  to  plot  the  one  and  two  hour 
circles  of  action  of  the  submarine. 

SUBAREA  Function 

sublncation  SUBAREA  R uses  sublocation#  a numeric  vector  of 
length  t\/o#  and  the  per  hour  speed  of  the  submarine#  R#  to  plot 
the  submarine's  position  and  circles  of  action  relative  to  US. 

CLSPLOT  Fi  notion 

sublocatlon  CLSPLOT  class  uses  the  submarine's  class  name 
to  find  Its  speed  and  then  uses  SUBAREA  to  do  the  plotting. 
Thus#  If  you  assume  that  we  ire  at  location  0#0  and  a submarine 
with  a particular  pennant  h.is  been  spotted  at  location  x#y#  the 
CLSPLOT  function  Is  all  that  is  neede<  to  plot  our  position 
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relative  to  the  one  and  two  hour  circles  of  action  of  the 
opposing  sub. 

PENPLOT  Function 

sublocation  I’ENPLOT  pennant^  uses  the  submarine's  pennant 
to  find  Its  clas'.  name  and  then  calls  CLSPLOT  to  find  the  sub's 
speed  and  plot  thf  one  and  two  hour  circles  of  action. 

APL 


The  user  should  realize  that  the  entire  power  of  APL  Is 
always  available  when  using  the  DAISY/ APL  Interface.  Thus,  a 
trained  user  could  define  new  functions,  perform  complex  side 
aj.cal  cul  at  Ions,  etc. 
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